.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH SP_LEAVE 3 "JULY 1998" SPREAD "User Manuals"
.SH NAME
SP_leave \- create connection between app and daemon
.SH SYNOPSIS
.B #include <sp.h>
.br
.BI "int SP_leave( mailbox " mbox ", const char *" group );
.SH DESCRIPTION
.B SP_leave
leaves a group with the name passed as the string
.I group.
If the group does not exist amoung the Spread daemons this
operation is ignored, otherwise the Leave leaves the existing group.
The
.I mbox
of the connection upon which to leave a group is the first parameter.</P>
The
.I group
 string represents the name of the group to leave.
.SH "RETURN VALUES"
Returns 0 on success or one of the following errors ( < 0 ):
.TP 0.8i
.B ILLEGAL_GROUP
The 
.I group
given to leave was illegal for some reason. Usually because it was of 
length 0 or length > MAX_GROUP_NAME
.TP
.B ILLEGAL_SESSION
The session specified by
.I mbox
is illegal. Usually because it is not active.
.TP
.B CONNECTION_CLOSED
During communication errors occured
and the leave could not be initiated.
.SH BUGS
None.
.SH AUTHOR
Yair Amir <yairamir@cnds.jhu.edu>
.br
Jonathan Stanton <jonathan@cnds.jhu.edu>
.br

.SH "SEE ALSO"
.BR libspread (3)

